home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / commoditys / windowtiler / windowtiler.doc < prev    next >
Text File  |  1996-04-07  |  9KB  |  236 lines
  1.    WindowTiler 2.1b -  6/25/92  by Doug Dyer
  2.    100% PD and freely distributable
  3.    The Complete Funola for the whole family!
  4.  
  5.  
  6. Folks, thought Id update the old commodity with a version that
  7. I never put on aminet.  I updated my contact information as 
  8. well.  Ignore the "New" in "What's New" :)
  9.  
  10. Also, REFUSESCREEN works but does not pass on the commodity
  11. event to the screen.  So if you were using TERM and wanted
  12. a key equivalent (say F1) that was being used by windowtiler
  13. to do a term specific thing, pressing F1 would not arrange
  14. the windows, but term wouldn't know about the F1 press.
  15. To work around this, you'll just have to pick your key
  16. equivalents well.
  17.  
  18. bye,
  19. Doug
  20.   
  21. ---------------------------
  22. What's New?
  23.  
  24. I have addressed almost all known problems and finally added virtual
  25. screen support.  Everything is now "solidified" and I can spend more
  26. time playing with a cute GUI for it.
  27.  
  28. New tooltypes since v2.0 are:  VISIBLE, VISIBLETOGGLE.
  29.  
  30. In general, everything works better and safer than v2.0.  The only
  31. known bug that irks me is the fact that you can "zipwindow" the 
  32. workbench screen as if it is a window.  I've tried comparing this
  33. and that flags for both the workbench screen and window, but no luck
  34. (I can stop the problem if I treat the wbench window AND screen as
  35. being illegal for zipping).  Its best to use C='s IHELP or FKEY for 
  36. this.
  37.  
  38. Fixed double-clicking problems (see the history table at the end of
  39. this file for details).
  40.  
  41. The "b" in 2.1b is cosmetic (see the history table at the end of
  42. this file).
  43.  
  44. A quick note on "EXPLODE".  This is not the cute rubber-banding of
  45. windows ala macs.  It is the enlargement of a window to fill the screen
  46. (and come up front) ala turbo-c, windows environments (and others).
  47. ---------------------------
  48. What is this thing?
  49.  
  50. WindowTiler is a simple commodity for os2.X users that allows you 
  51. to map certain Windows3.X/TurboC++ type window management to a key 
  52. combination. NOTE: if it does nothing try (using commodities exchange)  
  53. disabling any commodities that conflict for the same hotkeys. Although 
  54. it takes some getting used to, tiling/cascading the windows and zooming 
  55. one up to work & placing it back is a great way to handle large project.  
  56.  
  57. ---------------------------
  58. Instructions:
  59.  
  60. Select the WindowTiler icon, and then "information" in the workbench 
  61. menu. Then, in the list box add or edit the tools listed to conform to 
  62. keyboard equivalents you want.  For instance, to set CASCADE to alt-f10, 
  63. just type (with no extra spaces, and CAPITALIZATION MATTERS) 
  64. CASCADE=Alt F10.
  65.  
  66.  
  67. Keyboard Equivalents (well, not very documented..):
  68.  
  69.    Alt       (any alt key)
  70.    RAlt
  71.    LAlt
  72.    Shift     (any shift key)
  73.    RShift
  74.    LShift
  75.    RCommand
  76.    LCommand
  77.    Control
  78.    Numericpad
  79.    Rbutton   (mouse buttons)
  80.    Lbutton
  81.    A,B,...
  82.  
  83.  
  84. ----------------------------
  85. CUSTOM Tool types available: 
  86.  
  87.   CASCADE       Cascades all resizeable windows.
  88.  
  89.   CASCADELEFT   Cascades windows with right sides inset.   
  90.                 This one also leaves a bit of space on the right 
  91.                 side of the screen (I use that to get to my dock 
  92.                 window). This one is also easier to use since it 
  93.                 gives you access to the front/back gadgets.    
  94.  
  95.   TILE          Tiles windows 
  96.  
  97.   VTILE         Lists windows vertically
  98.  
  99.   HTILE         Lists windows horizontally
  100.  
  101.   MINIMIZE      Shrinks windows
  102.  
  103.   MAXIMIZE      Enlarges windows
  104.  
  105.   REFUSEWINDOW  Use cli arguments to omit windows from windowtiler
  106.                 such as REFUSE=~(#?shell#?) would let windowtiler 
  107.                 only affect windows with a title with "shell" in it.  
  108.                 Use this for windows such as "Clock", and others 
  109.                 that you wish refused. For example, 
  110.                 REFUSEWINDOW=(Workbench|Clock|#?shell) would not move
  111.                 the workbench, clock windows or any window ending in 
  112.                 "shell".
  113.  
  114.   DCLICK        This is a double-click feature with three options:
  115.    
  116.                 "EXPLODE" explodes the window up to front.  Pressing 
  117.                           the zoom gadget places it back where it came 
  118.                           from (ie: tile position). Activated by 
  119.                           double-clicking on window TITLE BAR.
  120.                        
  121.                 "TOFRONT" brings window to front. (click anywhere)
  122.                
  123.                 "BOTH"    Clicking on the title bar performs a ZOOM 
  124.                           and anywhere else, a FRONT.
  125.                        
  126.                 "NONE"    anything else will disable this feature.
  127.  
  128.                 NOTE: clicking on the zoom gadget in the window will 
  129.                 place it back into its tiled or cascaded place.
  130.  
  131.   EXPLODE       Same as DCLICK's EXPLODE, but allows for a keyboard 
  132.                 equivalent.
  133.                 
  134.   ZOOMTOGGLE    Same as pressing the window ZOOM gadget.
  135.  
  136.   TOFRONT       Same as DCLICK's TOFRONT, but allows for a keyboard 
  137.                 equivalent.
  138.  
  139.   TOBACK        Keyboard equivalent for sending a window to the very
  140.                 back.
  141.                 
  142.   REFUSESCREEN  Another DOS pattern string, this one allows 
  143.                 windowtiler to decide whether it should do anything for 
  144.                 a given screen.  For instance, to have it do nothing 
  145.                 when you are using prowrite, you might try 
  146.                 REFUSESCREEN=ProW#?
  147.  
  148.   NOHEIGHT      For high resolution screens, it is annoying for cascading 
  149.                 to give huge windows.  This tooltype will let windowtiler 
  150.                 only change the height of the window when needed (TRUE or 
  151.                 FALSE)
  152.  
  153.   NOWIDTH       Same as NOHEIGHT except for window width (TRUE or FALSE)
  154.  
  155.   SHOWTITLE     All arranged windows will display the screen title when 
  156.                 this is TRUE (even zooming windows).
  157.  
  158.   STEPDOWN      Now you can control the distance windows are "stepped" 
  159.                 for cascading.  This is for the downward step.
  160.  
  161.   STEPLEFT      Same as above except stepping left.
  162.  
  163.   CASCADEHEIGHT Fix the height of windows when they are cascaded.
  164.                 NOHEIGHT overrides this.  
  165.    
  166.   CASCADEWIDTH  Fix the width of windows when they are cascaded. NOWIDTH
  167.                 overrides this.
  168.  
  169.   VISIBLE       This is for VIRTUAL screens.  If VISIBLE is set to TRUE or
  170.                 YES, all arranged screens do so within the current visible
  171.                 screen area.  Otherwise, the virtual screen is used.
  172.                 
  173.   VISIBLETOGGLE This is for VIRTUAL screens.  You can toggle the default
  174.                 option you selected with VISIBLE with a keyboard equivalent.
  175.                                 
  176. ----------------------------
  177. Furthermore...
  178.  
  179. If you place this tool in your wbstartup drawer, don't forget the 
  180. DONOTWAIT (it should already be there).  I find the most useful setup 
  181. IHELP's cycle and zoom on f1, f2 and tile, cascadeleft on f3,f4 along with 
  182. DCLICK=BOTH (actually, set DCLICK to EXPLODE and use C='s click-to-front
  183. utility, its faster).  If you are a keyboard nut, get WindowShuffle by Stefan 
  184. Sticht. Nice to step through cascaded windows :)
  185.  
  186. The REFUSESCREEN is set to ~(#?Workbench#?), and CASCADEHEIGHT,
  187. CASCADELEFT are set to 200 and 140 respectively (NOHEIGHT and NOWIDTH
  188. are set to FALSE).
  189.  
  190. Any bugs or suggestions (this is an "amiga learning" project for me) ... 
  191. Thanks all who have suggested improvements or reported problems!  Special
  192. thanks to Franz Schwarz for the great input!
  193.  
  194. Enjoy!
  195.  
  196. Doug Dyer
  197. dyer@alx.sticomet.com
  198.  
  199. 5124 Observation Way
  200. Alexandria, VA  22312
  201. USA
  202.  
  203. -----------------------
  204. Version History:
  205.  
  206. 1.0     1/17/92 Inception. 
  207.  
  208. 1.1     1/19/92 Added CASCADELEFT tooltype.  Enhanced cascading to
  209.         ignore non-sizeable windows (so things like toolmanager
  210.         dock are left alone).  Improved depth arranging of cascading
  211.         (now using MoveWindowInFrontOf).
  212.  
  213. 1.2     1/25/92 Added REFUSE tooltype. Added DCLICK tooltype.
  214.         Enhanced performance.  Added ZOOMIT, FRONTIT tooltypes.
  215.  
  216. 1.2.1   1/29/92 Fixed a bug: ZOOM did the same as BOTH.
  217.  
  218. 1.3     3/21/92 Fixed a bug: seems htile and vtile were.. ah.. switched.
  219.         Added REFUSESCREEN, NOHEIGHT, NOWIDTH, STEPLEFT, STEPDOWN, 
  220.         SHOWTITLE tooltypes.
  221.  
  222. 2.0     5/30/92 Better use of LockIBases... (oops).  Cleaner code and
  223.         internal organization. I changed some tooltype names to make 
  224.         more sense.  Added TOBACK, ZOOMTOGGLE, CASCADEHEIGHT and 
  225.         CASCADEWIDTH. Constructed a GUI for configuring it, but haven't 
  226.         hooked it in yet...
  227.  
  228. 2.1     6/17/92 Better use of everything.  Virtual screen support via
  229.         new tool types VISIBLE, VISIBLETOGGLE.  Double clicking on front-
  230.         back gadget will not explode windows.  Double clicking on drawer
  231.         will not explode new window if title happens to now be under the
  232.         pointer.  GUI still not linked in yet, but the commodity is now
  233.         "mature" and highly useable by a wide variety of tastes.
  234.  
  235. 2.1.b   6/25/92 Purely cosmetic (SHOWTITLE arrangements look better).
  236.